
<!DOCTYPE html>
<!--

    Copyright (c) 2017, 2019 Oracle and/or its affiliates. All rights reserved.

    This program and the accompanying materials are made available under the
    terms of the Eclipse Public License v. 2.0, which is available at
    http://www.eclipse.org/legal/epl-2.0.

    This Source Code may also be made available under the following Secondary
    Licenses when the conditions for such availability set forth in the
    Eclipse Public License v. 2.0 are satisfied: GNU General Public License,
    version 2 with the GNU Classpath Exception, which is available at
    https://www.gnu.org/software/classpath/license.html.

    SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0

-->
<!-- Portions Copyright [2019] [Payara Foundation and/or its affiliates] -->
<html lang="en">
  <head>
    <meta charset="utf-8"/>
    <title>uninstall-node-dcom</title>
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <link href="css/style.css" rel="stylesheet">
    <script src="https://use.fontawesome.com/96c4d89611.js"></script>
  </head>
  <body>
<table id="doc-title" cellspacing="0" cellpadding="0">
  <tr>
  <td align="left" valign="top">
  <b>uninstall-node-dcom</b><br />
  </td>
  </tr>
</table>
<hr />

<table width="90%" id="top-nav" cellspacing="0" cellpadding="0">
	<colgroup>
		<col width="12%"/>
		<col width="12%"/>
		<col width="*"/>
	</colgroup>
	<tr>
		<td align="left">
		<a href="uninstall-node.html">
			<span class="vector-font"><i class="fa fa-arrow-circle-left" aria-hidden="true"></i></span>
			<span style="position:relative;top:-2px;">Previous</span>
		</a>
		</td>

		<td align="left">
		<a href="uninstall-node-ssh.html">
			<span class=" vector-font"><i class="fa fa-arrow-circle-right vector-font" aria-hidden="true"></i></span>
			<span style="position:relative;top:-2px;">Next</span>
		</a>
		</td>

		<td align="right">
		<a href="toc.html">
			<span class=" vector-font"><i class="fa fa-list vector-font" aria-hidden="true"></i></span>
			<span style="position:relative;top:-2px;">Contents</span>
		</a>
		</td>
	</tr>
</table>


<div id="preamble">
<div class="sectionbody">
<div class="paragraph">
<p><a id="uninstall-node-dcom-1"></a><a id="GSRFM775"></a><a id="uninstall-node-dcom"></a></p>
</div>
</div>
</div>
<div class="sect1">
<h2 id="_uninstall_node_dcom">uninstall-node-dcom</h2>
<div class="sectionbody">
<div class="paragraph">
<p>uninstalls \{product---name} software from specified DCOM-enabled hosts</p>
</div>
<div id="sthref2215" class="paragraph">
<p>Synopsis</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="prettyprint highlight"><code class="language-oac_no_warn" data-lang="oac_no_warn">asadmin [asadmin-options] uninstall-node-dcom [--help]
[--installdir as-install-parent]
[--windowsuser windows-user] [--windowsdomain windows-domain]
[--force={false|true}]
host-list</code></pre>
</div>
</div>
<div id="sthref2216" class="paragraph">
<p>Description</p>
</div>
<div class="paragraph">
<p>The <code>uninstall-node-dcom</code> subcommand uninstalls \{product---name}
software from the hosts that are specified as the operand of the
subcommand. This subcommand requires the Distributed Component Object
Model (DCOM) remote protocol to be configured on the host where the
subcommand is run and on each host where the \{product---name} software
is being uninstalled.</p>
</div>
<div class="admonitionblock note">
<table>
<tr>
<td class="icon">
<div class="title">Note</div>
</td>
<td class="content">
<div class="paragraph">
<p>To uninstall \{product---name} software on hosts that use secure shell
(SSH), use the
<a href="uninstall-node-ssh.html#uninstall-node-ssh-1"><code>uninstall-node-ssh</code>(1)</a>
subcommand.</p>
</div>
</td>
</tr>
</table>
</div>
<div class="paragraph">
<p>By default, if any node except the predefined node <code>localhost-`domain
resides on any host from which \{product---name} software is being
uninstalled, the subcommand fails. To uninstall the \{product---name}
software from a host on which user-defined nodes reside, set the
`--force</code> option to <code>true</code>. If the <code>--force</code> option is <code>true</code>, the
subcommand removes the entire content of the parent of the base
installation directory.</p>
</div>
<div class="paragraph">
<p>If a file under the parent of the base installation directory is open,
the subcommand fails.</p>
</div>
<div class="paragraph">
<p>If multiple hosts are specified, the configuration of the following
items must be the same on all hosts:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>Parent of the base installation directory for the \{product---name}
software</p>
</li>
<li>
<p>Windows user</p>
</li>
<li>
<p>Windows domain</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>The subcommand does not modify the configuration of the domain
administration server (DAS).</p>
</div>
<div class="paragraph">
<p>This subcommand is supported in local mode only.</p>
</div>
<div id="sthref2217" class="paragraph">
<p>Options</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1">asadmin-options</dt>
<dd>
<p>Options for the <code>asadmin</code> utility. For information about these
options, see the <a href="asadmin.html#asadmin-1m"><code>asadmin</code>(1M)</a> help page.</p>
</dd>
<dt class="hdlist1"><code>--help</code></dt>
<dt class="hdlist1"><code>-?</code></dt>
<dd>
<p>Displays the help text for the subcommand.</p>
</dd>
<dt class="hdlist1"><code>--installdir</code></dt>
<dd>
<p>The absolute path to the parent of the base installation directory
where the \{product---name} software is installed on each host, for
example, <code>C:\glassfish3</code>.<br>
The user that is running this subcommand must have write access to the
specified directory. Otherwise, an error occurs.<br>
The specified directory must contain the installation of the
\{product---name} software on the host. Otherwise, an error occurs.<br>
The default is the parent of the base installation directory of the
\{product---name} software on the host where this subcommand is run.</p>
</dd>
<dt class="hdlist1"><code>--windowsuser</code></dt>
<dt class="hdlist1"><code>-w</code></dt>
<dd>
<p>The user on this node&#8217;s host that is to run the process for connecting
to the host through DCOM. The default is the user that is running the
DAS process.</p>
</dd>
<dt class="hdlist1"><code>--windowsdomain</code></dt>
<dt class="hdlist1"><code>-d</code></dt>
<dd>
<p>The name of the Windows domain that contains the user that the
<code>--windowsuser</code> option specifies. The default is the name of the host
on which the subcommand is run.</p>
</dd>
<dt class="hdlist1"><code>--force</code></dt>
<dd>
<p>Specifies whether the subcommand uninstalls the \{product---name}
software from a host even if a user-defined node resides on the host.
Possible values are as follows:<br></p>
<div class="dlist">
<dl>
<dt class="hdlist1"><code>false</code></dt>
<dd>
<p>If a user-defined node resides on a host, the software is not
uninstalled and the subcommand fails (default).<br>
If the <code>--force</code> option is <code>false</code>, the subcommand removes only the
\{product---name} software files. Other content if the parent of the
base installation directory, such as configuration files, are not
removed.</p>
</dd>
<dt class="hdlist1"><code>true</code></dt>
<dd>
<p>The subcommand uninstalls the \{product---name} software from the
host even if a user-defined node resides on the host.<br>
If the <code>--force</code> option is <code>true</code>, the subcommand removes the entire
content of the parent of the base installation directory.</p>
</dd>
</dl>
</div>
</dd>
</dl>
</div>
<div id="sthref2218" class="paragraph">
<p>Operands</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1">host-list</dt>
<dd>
<p>A space-separated list of the names of the hosts from which the
\{product---name} software is to be uninstalled.</p>
</dd>
</dl>
</div>
<div id="sthref2219" class="paragraph">
<p>Examples</p>
</div>
<div class="paragraph">
<p><a id="GSRFM776"></a><a id="sthref2220"></a></p>
</div>
<div class="paragraph">
<p>Example 1   Uninstalling \{product---name} Software From the Default
Location</p>
</div>
<div class="paragraph">
<p>This example uninstalls \{product---name} software on the hosts
<code>wpmdl1.example.com</code> and <code>wpmdl2.example.com</code> from the default location.</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="prettyprint highlight"><code class="language-oac_no_warn" data-lang="oac_no_warn">asadmin&gt; uninstall-node-dcom wpmdl1 wpmdl2
Command uninstall-node-dcom executed successfully.</code></pre>
</div>
</div>
<div class="paragraph">
<p><a id="GSRFM777"></a><a id="sthref2221"></a></p>
</div>
<div class="paragraph">
<p>Example 2   Forcibly Uninstalling \{product---name} Software</p>
</div>
<div class="paragraph">
<p>This example uninstalls \{product---name} software on the host
<code>xkyd.example.com</code>.</p>
</div>
<div class="paragraph">
<p>The software is uninstalled even if a user-defined node resides on the
host. The entire content of the <code>C:\glassfish3</code> directory is removed.</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="prettyprint highlight"><code class="language-oac_no_warn" data-lang="oac_no_warn">asadmin&gt; uninstall-node-dcom --force --installdir C:\glassfish3 xkyd.example.com
Command uninstall-node-dcom executed successfully.</code></pre>
</div>
</div>
<div id="sthref2222" class="paragraph">
<p>Exit Status</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1">0</dt>
<dd>
<p>command executed successfully</p>
</dd>
<dt class="hdlist1">1</dt>
<dd>
<p>error in executing the command</p>
</dd>
</dl>
</div>
<div id="sthref2223" class="paragraph">
<p>See Also</p>
</div>
<div class="paragraph">
<p><a href="asadmin.html#asadmin-1m"><code>asadmin</code>(1M)</a></p>
</div>
<div class="paragraph">
<p><a href="install-node-dcom.html#install-node-dcom-1"><code>install-node-dcom</code>(1)</a>,
<a href="uninstall-node-ssh.html#uninstall-node-ssh-1"><code>uninstall-node-ssh</code>(1)</a></p>
</div>
</div>
</div>

<hr />

<table width="90%" id="bottom-nav" cellspacing="0" cellpadding="0">
	<colgroup>
		<col width="12%"/>
		<col width="12%"/>
		<col width="*"/>
	</colgroup>
	<tr>		
		<td align="left">
		<a href="uninstall-node.html">
			<span class=" vector-font"><i class="fa fa-arrow-circle-left" aria-hidden="true"></i></span>
			<span style="position:relative;top:-2px;">Previous</span>
		</a>
		</td>

		<td align="left">
		<a href="uninstall-node-ssh.html">
			<span class="vector-font"><i class="fa fa-arrow-circle-right vector-font" aria-hidden="true"></i></span>
			<span style="position:relative;top:-2px;">Next</span>
		</a>
		</td>

		<td align="right">
		<a href="toc.html">
			<span class="vector-font"><i class="fa fa-list vector-font" aria-hidden="true"></i></span>
			<span style="position:relative;top:-2px;">Contents</span>
		</a>
		</td>
	</tr>
</table>

<span id="copyright">
        <img src="/resource/reference/img/eclipse_foundation_logo_tiny.png" height="20px" alt="Eclipse Foundation Logo" align="top"/>&nbsp;            
        <span >Copyright&nbsp;&copy;&nbsp;2019,&nbsp;Oracle&nbsp;and/or&nbsp;its&nbsp;affiliates.&nbsp;All&nbsp;rights&nbsp;reserved.</span>
</span>

</body>
</html>
